Für den Export von Artikel-, Kontakte- und Projektdatensätzen zur Weiterverwendung in Web-Anwendungen steht eine Schnittstelle zur Verfügung, die einmalig in den Programmeinstellungen konfiguriert wird und über einen Web-Request gestartet wird.
Für jedes der 3 möglichen Module steht ein separater Konfigurationsbereich zur Verfügung.
Für die Suche per Web-Request wird ein Datenbankfeld festgelegt. Der Suchstring kann so genannte Wildcards enthalten, möglich sind "*" oder "@". Nach diesem Feld werden die exportierten Datensätze außerdem sortiert. Per Doppelklick auf das Feld "Suchen nach" öffnet die Feldauswahl, über die das gewünschte Feld ausgewählt werden kann.
Umfang und Inhalt der XML Ausgabedatei sind frei definierbar. Die XML-Knoten können entsprechend der Anforderungen der externen Anwendung frei benannt werden und können feste Werte, Datenbankfelder, Formeln und Benutzerfelder (über eine Formel) enthalten.
XML-Knoten | Ausgabewert |
fix | abc |
feld | [Kontakte]KundenNr |
formel | [Kontakte]Strasse+", "+[Kontakte]PLZ+" "+[Kontakte]Ort |
benutzer_feld | BF_GetText ([Kontakte]OID;"ContactStatus") |
Ein neuer Knoten wird über den Button hinzugefügt. Per Doppelklick auf die Zeile öffnet ein Editor, über den die Bezeichnung des Knotens und der Datentyp ausgewählt werden. Ein fester Wert kann direkt in das entsprechende Feld geschrieben werden. Für die Verwendung eines Feldes oder einer Formel öffnet per Doppleklick auf das Feld "Wert" ein weiterer Dialog.
Innerhalb eines XML-Knotens sind einzeilige Formeln möglich. Komplexere Formeln müssen per Skript gebildet und über ‘EXEC_Script({script_name}{;param1{;param2;…}})’ eingefügt werden.
Benutzerfelder werden über die API Funktion ‘BF_GetText({record-ID};{user field name})’ geladen.
Um einen XML Knoten zu ändern, wird doppelt auf die entsprechende Zeile geklickt. Gelöscht wird ein XML-Knoten über den Button .
Web-Aufruf
Über die URL {ingenious.V12 webserver}/xml_export&module={module}&select={searchstring} wird der Web-Aufruf gestartet.
{ingenious.V12 webserver} steht für die Web-Adresse bzw. IP des eigenen Webservers.
Für {module} wird das Modul eingetragen, in dem gesucht werden soll.
Für {searchstring} ist der Suchbegriff einzutragen. Dieser kann die Wildcards "*" und "@" enthalten, die für unbekannte Zeichen im Suchbegriff stehen.
Der Web-Aufruf erzeugt eine XML mit folgendem Aufbau:
Web Aufruf XML |
Kopiere Code |
---|---|
<?xml version="1.0" encoding="UTF-8" standalone="no" ?> <xml_export records="{Anzahl exportierte Datensätze}"> <record num="{Datensatz Nummer}"> <{Generischer XML Knoten 1}> {Exportierter Wert 1} </{Generischer XML Knoten 1}> <{Generischer XML Knoten 2}> {Exportierter Wert 2} </{Generischer XML Knoten 2}> { ... } </record> { ... } |